MarkLogic 12 Product Documentation
POST /manage/v2/clusters/{id|name}/dynamic-host-token

Summary

This resource creates a dynamic host token that can be used to initialize dynamic hosts.

URL Parameters
format The format of the posted data. Can be either html, json, or xml (default). This value overrides the Accept header if both are present.
Request Headers
Accept The expected MIME type of the request body. If the format? parameter is present, it takes precedence over the Accept header.
Content-type The MIME type of the data in the request body. Depending upon the value of the format parameter or Accept header, one of application/xml, application/json, or text/html.
Response Headers
Content-type The MIME type of the data in the response body. Depending upon the value of the format parameter or Accept header, one of application/xml, application/json, or text/html.

Response

Upon success, MarkLogic Server returns a status code of 201 (Created). The response body includes a dynamic-host-token element if successful. A status code of 401 (Unauthorized) is returned if the user does not have the necessary privileges.

Required Privileges

This operation requires the manage-admin role, or the following privileges:

Usage Notes

If the request targets a foreign cluster, a status code of 400 (Bad Request) is returned.

Example


curl --anyauth --user admin:admin -i -X POST localhost:8002/manage/v2/clusters/Default/dynamic-host-token \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"dynamic-host-token": {"group": "Default","host": "join-host.foo.bar", "port":8001, "duration": "PT10M","comment": "some"}}'
==> returns a dynamic-host-token element in the response body.
Powered by MarkLogic Server | Terms of Use | Privacy Policy